{ "bundles": [ { "@type": "NXBundle", "artifactId": "nuxeo-platform-mail-core", "artifactVersion": "10.10-HF20", "bundleGroup": { "@type": "NXBundleGroup", "bundleIds": [ "org.nuxeo.ecm.platform.mail", "org.nuxeo.ecm.platform.mail.jsf", "org.nuxeo.ecm.platform.mail.types", "org.nuxeo.ecm.platform.mail.webui" ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail", "id": "grp:org.nuxeo.ecm.platform.mail", "name": "org.nuxeo.ecm.platform.mail", "parentIds": [ "grp:org.nuxeo.ecm.platform" ], "readmes": [ { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n", "digest": "5c14b7245188fbe51fcebd6e4c6eff98", "encoding": "UTF-8", "length": 7955, "mimeType": "text/plain", "name": "README.md" }, { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" } ], "version": "10.10" }, "bundleId": "org.nuxeo.ecm.platform.mail", "components": [ { "@type": "NXComponent", "componentClass": "org.nuxeo.ecm.platform.mail.service.MailServiceImpl", "documentation": "\n Services to to manage mails.\n\n @author Alexandre Russel\n", "documentationHtml": "

\nServices to to manage mails.\n

", "extensionPoints": [ { "@type": "NXExtensionPoint", "componentId": "org.nuxeo.ecm.platform.MailService", "descriptors": [ "org.nuxeo.ecm.platform.mail.service.SessionFactoryDescriptor" ], "documentation": "\n\n Extension point to register a session factory.\n\n

\n A session factory allows to create session for users. To create sessions\n the factory needs informations such as host, port, protocol ... The list\n of needed properties depends on the protocol used and if you need store,\n transport or both. For more information see the\n \n JavaMail API\n \n .\n

\n

\n To get hold of a Session call: MailService mailService =\n Framework.getService(MailSerivce.class); Transport transport =\n mailSerivce.getTransport(\"myFactory\"); Store store =\n mailServcie.getStore(\"myFactory\");\n

\n

\n The default is to get a session for the authenticated user if any, or\n you can pass a String to get a session for a user.\n

\n", "documentationHtml": "

\nExtension point to register a session factory.\n

\n

\nA session factory allows to create session for users. To create sessions\nthe factory needs informations such as host, port, protocol ... The list\nof needed properties depends on the protocol used and if you need store,\ntransport or both. For more information see the\n\nJavaMail API\n\n.\n

\n

\nTo get hold of a Session call: MailService mailService =\nFramework.getService(MailSerivce.class); Transport transport =\nmailSerivce.getTransport("myFactory"); Store store =\nmailServcie.getStore("myFactory");\n

\n

\nThe default is to get a session for the authenticated user if any, or\nyou can pass a String to get a session for a user.\n

", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.MailService/ExtensionPoints/org.nuxeo.ecm.platform.MailService--sessionFactory", "id": "org.nuxeo.ecm.platform.MailService--sessionFactory", "label": "sessionFactory (org.nuxeo.ecm.platform.MailService)", "name": "sessionFactory", "version": "10.10-HF20" }, { "@type": "NXExtensionPoint", "componentId": "org.nuxeo.ecm.platform.MailService", "descriptors": [ "org.nuxeo.ecm.platform.mail.fetcher.PropertiesFetcherDescriptor" ], "documentation": "\n Extension point to register a properties fetcher.\n

\n The responsability of a property fetcher is to fetch properties from any\n backend.\n

\n", "documentationHtml": "

\nExtension point to register a properties fetcher.\n

\nThe responsability of a property fetcher is to fetch properties from any\nbackend.\n

", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.MailService/ExtensionPoints/org.nuxeo.ecm.platform.MailService--propertiesFetcher", "id": "org.nuxeo.ecm.platform.MailService--propertiesFetcher", "label": "propertiesFetcher (org.nuxeo.ecm.platform.MailService)", "name": "propertiesFetcher", "version": "10.10-HF20" }, { "@type": "NXExtensionPoint", "componentId": "org.nuxeo.ecm.platform.MailService", "descriptors": [ "org.nuxeo.ecm.platform.mail.action.MessageActionPipeDescriptor" ], "documentation": "\n Extension point to register a list of actions.\n\n

\n An ActionPipe is a list of ActionMessage used for mail import. Default contribution\n are merged but you can override them using 'override' attribute. \n\n \n \n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n \n

\n

\n When registering the ActionPipe, the service looks for an ActionMessage named\n 'StartAction', so this is a mandatory attribute. Registration of the pipe ends when\n service doesn't find the next action.\n

\n

\n Since 6.0, you can use Automation to control how Documents are created from email. \n For that you need to redefine the ActionPipe.\n \n \n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n \n \n \n \n Then the CreateMailDocumentFromAutomation Chain whill be used to create the content.\n

\n", "documentationHtml": "

\nExtension point to register a list of actions.\n

\n

\nAn ActionPipe is a list of ActionMessage used for mail import. Default contribution\nare merged but you can override them using 'override' attribute.\n

\n

        <pipe name="nxmail" override="true">\n            <action id="StartAction" to="CreateDocumentsAction">\n            org.nuxeo.ecm.platform.mail.listener.action.StartAction\n          </action>\n            <action id="CreateDocumentsAction">\n            org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n          </action>\n        </pipe>\n

\n

\n

\nWhen registering the ActionPipe, the service looks for an ActionMessage named\n'StartAction', so this is a mandatory attribute. Registration of the pipe ends when\nservice doesn't find the next action.\n

\n

\nSince 6.0, you can use Automation to control how Documents are created from email.\nFor that you need to redefine the ActionPipe.\n

        <pipe name="nxmail" override="true">\n            <action>\n            org.nuxeo.ecm.platform.mail.listener.action.StartAction\n          </action>\n            <action>\n            org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n          </action>\n            <action chain="CreateMailDocumentFromAutomation">\n            org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n          </action>\n        </pipe>\n

\nThen the CreateMailDocumentFromAutomation Chain whill be used to create the content.\n

", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.MailService/ExtensionPoints/org.nuxeo.ecm.platform.MailService--actionPipes", "id": "org.nuxeo.ecm.platform.MailService--actionPipes", "label": "actionPipes (org.nuxeo.ecm.platform.MailService)", "name": "actionPipes", "version": "10.10-HF20" } ], "extensions": [], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.MailService", "name": "org.nuxeo.ecm.platform.MailService", "requirements": [], "resolutionOrder": 428, "services": [ { "@type": "NXService", "componentId": "org.nuxeo.ecm.platform.MailService", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.MailService/Services/org.nuxeo.ecm.platform.mail.service.MailService", "id": "org.nuxeo.ecm.platform.mail.service.MailService", "overriden": false, "version": "10.10-HF20" } ], "startOrder": 881, "version": "10.10-HF20", "xmlFileContent": "\n\n \n Services to to manage mails.\n\n @author Alexandre Russel\n \n \n \n \n \n \n \n Extension point to register a session factory.\n\n

\n A session factory allows to create session for users. To create sessions\n the factory needs informations such as host, port, protocol ... The list\n of needed properties depends on the protocol used and if you need store,\n transport or both. For more information see the\n \n JavaMail API\n \n .\n

\n

\n To get hold of a Session call: MailService mailService =\n Framework.getService(MailSerivce.class); Transport transport =\n mailSerivce.getTransport(\"myFactory\"); Store store =\n mailServcie.getStore(\"myFactory\");\n

\n

\n The default is to get a session for the authenticated user if any, or\n you can pass a String to get a session for a user.\n

\n \n \n \n \n \n Extension point to register a properties fetcher.\n

\n The responsability of a property fetcher is to fetch properties from any\n backend.\n

\n \n \n \n\n \n \n Extension point to register a list of actions.\n\n

\n An ActionPipe is a list of ActionMessage used for mail import. Default contribution\n are merged but you can override them using 'override' attribute. \n\n \n \n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n \n

\n\n

\n When registering the ActionPipe, the service looks for an ActionMessage named\n 'StartAction', so this is a mandatory attribute. Registration of the pipe ends when\n service doesn't find the next action.\n

\n\n

\n Since 6.0, you can use Automation to control how Documents are created from email. \n For that you need to redefine the ActionPipe.\n \n \n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n \n \n \n \n Then the CreateMailDocumentFromAutomation Chain whill be used to create the content.\n

\n\n \n \n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-framework.xml", "xmlPureComponent": false }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.MailService--propertiesFetcher", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.service.MailServiceContrib/Contributions/org.nuxeo.ecm.platform.mail.service.MailServiceContrib--propertiesFetcher", "id": "org.nuxeo.ecm.platform.mail.service.MailServiceContrib--propertiesFetcher", "registrationOrder": 0, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.MailService", "name": "org.nuxeo.ecm.platform.MailService", "type": "service" }, "version": "10.10-HF20", "xml": "\n \n " }, { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.MailService--actionPipes", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.service.MailServiceContrib/Contributions/org.nuxeo.ecm.platform.mail.service.MailServiceContrib--actionPipes", "id": "org.nuxeo.ecm.platform.mail.service.MailServiceContrib--actionPipes", "registrationOrder": 0, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.MailService", "name": "org.nuxeo.ecm.platform.MailService", "type": "service" }, "version": "10.10-HF20", "xml": "\n\n \n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n\n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.service.MailServiceContrib", "name": "org.nuxeo.ecm.platform.mail.service.MailServiceContrib", "requirements": [ "org.nuxeo.ecm.platform.MailService" ], "resolutionOrder": 429, "services": [], "startOrder": 386, "version": "10.10-HF20", "xmlFileContent": "\n\n org.nuxeo.ecm.platform.MailService\n\n \n \n \n \n \n\n \n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n\n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.event.EventServiceComponent--listener", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.listener.contrib/Contributions/org.nuxeo.ecm.platform.mail.core.listener.contrib--listener", "id": "org.nuxeo.ecm.platform.mail.core.listener.contrib--listener", "registrationOrder": 29, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.event.EventServiceComponent", "name": "org.nuxeo.ecm.core.event.EventServiceComponent", "type": "service" }, "version": "10.10-HF20", "xml": "\n \n MailReceivedEvent\n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.listener.contrib", "name": "org.nuxeo.ecm.platform.mail.core.listener.contrib", "requirements": [], "resolutionOrder": 430, "services": [], "startOrder": 378, "version": "10.10-HF20", "xmlFileContent": "\n\n\n \n \n MailReceivedEvent\n \n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-listener-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.api.blobholder.BlobHolderAdapterComponent--BlobHolderFactory", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.blobholder/Contributions/org.nuxeo.ecm.platform.mail.core.blobholder--BlobHolderFactory", "id": "org.nuxeo.ecm.platform.mail.core.blobholder--BlobHolderFactory", "registrationOrder": 1, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.api.blobholder.BlobHolderAdapterComponent", "name": "org.nuxeo.ecm.core.api.blobholder.BlobHolderAdapterComponent", "type": "service" }, "version": "10.10-HF20", "xml": "\n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.blobholder", "name": "org.nuxeo.ecm.platform.mail.core.blobholder", "requirements": [], "resolutionOrder": 431, "services": [], "startOrder": 376, "version": "10.10-HF20", "xmlFileContent": "\n\n\n \n \n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-blobholder-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.operation.OperationServiceComponent--chains", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.mail.automation.chains/Contributions/org.nuxeo.mail.automation.chains--chains", "id": "org.nuxeo.mail.automation.chains--chains", "registrationOrder": 4, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.operation.OperationServiceComponent", "name": "org.nuxeo.ecm.core.operation.OperationServiceComponent", "type": "service" }, "version": "10.10-HF20", "xml": "\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:htmlText\",Context[\"text\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.mail.automation.chains", "name": "org.nuxeo.mail.automation.chains", "requirements": [], "resolutionOrder": 432, "services": [], "startOrder": 727, "version": "10.10-HF20", "xmlFileContent": "\n\n\n\n \n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:htmlText\",Context[\"text\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n \n\n\n ", "xmlFileName": "/OSGI-INF/automation-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.operation.OperationServiceComponent--operations", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.operations.contrib/Contributions/org.nuxeo.ecm.platform.mail.core.operations.contrib--operations", "id": "org.nuxeo.ecm.platform.mail.core.operations.contrib--operations", "registrationOrder": 15, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.operation.OperationServiceComponent", "name": "org.nuxeo.ecm.core.operation.OperationServiceComponent", "type": "service" }, "version": "10.10-HF20", "xml": "\n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.operations.contrib", "name": "org.nuxeo.ecm.platform.mail.core.operations.contrib", "requirements": [], "resolutionOrder": 433, "services": [], "startOrder": 379, "version": "10.10-HF20", "xmlFileContent": "\n\n \n \n \n\n", "xmlFileName": "/OSGI-INF/operations-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.security.SecurityService--policies", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.securitypolicy.contrib/Contributions/org.nuxeo.ecm.platform.mail.core.securitypolicy.contrib--policies", "id": "org.nuxeo.ecm.platform.mail.core.securitypolicy.contrib--policies", "registrationOrder": 2, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.security.SecurityService", "name": "org.nuxeo.ecm.core.security.SecurityService", "type": "service" }, "version": "10.10-HF20", "xml": "\n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.core.securitypolicy.contrib", "name": "org.nuxeo.ecm.platform.mail.core.securitypolicy.contrib", "requirements": [], "resolutionOrder": 434, "services": [], "startOrder": 380, "version": "10.10-HF20", "xmlFileContent": "\n\n \n \n \n\n", "xmlFileName": "/OSGI-INF/security-policy-contrib.xml", "xmlPureComponent": true } ], "fileName": "nuxeo-platform-mail-core-10.10-HF20.jar", "groupId": "org.nuxeo.ecm.platform", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail", "id": "org.nuxeo.ecm.platform.mail", "location": "", "manifest": "Manifest-Version: 1.0\r\nArchiver-Version: Plexus Archiver\r\nCreated-By: Apache Maven\r\nBuilt-By: jenkins\r\nBuild-Jdk: 1.8.0_222\r\nBundle-ManifestVersion: 2\r\nBundle-Version: 10.10-HF20-t20191228-021538\r\nBundle-Name: Nuxeo ECM Mail Core\r\nBundle-SymbolicName: org.nuxeo.ecm.platform.mail;singleton:=true\r\nBundle-Vendor: Nuxeo\r\nRequire-Bundle: org.nuxeo.ecm.core.api,org.nuxeo.ecm.core.event\r\nEclipse-LazyStart: false\r\nNuxeo-Component: OSGI-INF/nxmail-framework.xml,OSGI-INF/nxmail-contrib\r\n .xml,OSGI-INF/nxmail-listener-contrib.xml,OSGI-INF/nxmail-blobholder-\r\n contrib.xml,OSGI-INF/automation-contrib.xml,OSGI-INF/operations-contr\r\n ib.xml,OSGI-INF/security-policy-contrib.xml\r\nProvide-Package: org.nuxeo.ecm.platform.mail\r\n\r\n", "maxResolutionOrder": 434, "minResolutionOrder": 428, "packages": [ "nuxeo-10.10-HF20", "nuxeo-imap-connector" ], "parentReadme": { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n", "digest": "5c14b7245188fbe51fcebd6e4c6eff98", "encoding": "UTF-8", "length": 7955, "mimeType": "text/plain", "name": "README.md" }, "requirements": [ "org.nuxeo.ecm.core.api", "org.nuxeo.ecm.core.event" ], "version": "10.10-HF20" }, { "@type": "NXBundle", "artifactId": "nuxeo-platform-mail-jsf", "artifactVersion": "10.10", "bundleGroup": { "@type": "NXBundleGroup", "bundleIds": [ "org.nuxeo.ecm.platform.mail", "org.nuxeo.ecm.platform.mail.jsf", "org.nuxeo.ecm.platform.mail.types", "org.nuxeo.ecm.platform.mail.webui" ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail", "id": "grp:org.nuxeo.ecm.platform.mail", "name": "org.nuxeo.ecm.platform.mail", "parentIds": [ "grp:org.nuxeo.ecm.platform" ], "readmes": [ { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n", "digest": "5c14b7245188fbe51fcebd6e4c6eff98", "encoding": "UTF-8", "length": 7955, "mimeType": "text/plain", "name": "README.md" }, { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" } ], "version": "10.10" }, "bundleId": "org.nuxeo.ecm.platform.mail.jsf", "components": [ { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.actions.ActionService--actions", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.actions.contrib/Contributions/org.nuxeo.ecm.platform.mail.jsf.actions.contrib--actions", "id": "org.nuxeo.ecm.platform.mail.jsf.actions.contrib--actions", "registrationOrder": 24, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.actions.ActionService", "name": "org.nuxeo.ecm.platform.actions.ActionService", "type": "service" }, "version": "10.10", "xml": "\n \n \n not_mail_message_document\n \n \n \n not_mail_message_document\n \n \n \n not_mail_folder_document\n \n \n \n not_mail_folder_document\n \n\n " }, { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.actions.ActionService--filters", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.actions.contrib/Contributions/org.nuxeo.ecm.platform.mail.jsf.actions.contrib--filters", "id": "org.nuxeo.ecm.platform.mail.jsf.actions.contrib--filters", "registrationOrder": 10, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.actions.ActionService", "name": "org.nuxeo.ecm.platform.actions.ActionService", "type": "service" }, "version": "10.10", "xml": "\n\n \n \n MailMessage\n \n \n \n \n \n MailFolder\n \n \n\n " }, { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.actions.ActionService--actions", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.actions.contrib/Contributions/org.nuxeo.ecm.platform.mail.jsf.actions.contrib--actions1", "id": "org.nuxeo.ecm.platform.mail.jsf.actions.contrib--actions1", "registrationOrder": 25, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.actions.ActionService", "name": "org.nuxeo.ecm.platform.actions.ActionService", "type": "service" }, "version": "10.10", "xml": "\n\n\t \n\t SUBVIEW_UPPER_LIST\n\t \n\t \n\t MailFolder\n\t \n\t \n\t \n\n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.actions.contrib", "name": "org.nuxeo.ecm.platform.mail.jsf.actions.contrib", "requirements": [], "resolutionOrder": 435, "services": [], "startOrder": 382, "version": "10.10", "xmlFileContent": "\r\n\r\n\r\n\r\n \r\n \r\n \r\n not_mail_message_document\r\n \r\n \r\n \r\n not_mail_message_document\r\n \r\n \r\n \r\n not_mail_folder_document\r\n \r\n \r\n \r\n not_mail_folder_document\r\n \r\n\r\n \r\n\r\n \r\n\r\n \r\n \r\n MailMessage\r\n \r\n \r\n \r\n \r\n \r\n MailFolder\r\n \r\n \r\n\r\n \r\n \r\n \r\n\r\n\t \r\n\t SUBVIEW_UPPER_LIST\r\n\t \r\n\t \r\n\t MailFolder\r\n\t \r\n\t \r\n\t \r\n\r\n \r\n \r\n\r\n", "xmlFileName": "/OSGI-INF/nxmail-actions-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.ui.web.ContentViewService--contentViews", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.contentview.contrib/Contributions/org.nuxeo.ecm.platform.mail.jsf.contentview.contrib--contentViews", "id": "org.nuxeo.ecm.platform.mail.jsf.contentview.contrib--contentViews", "registrationOrder": 5, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.ui.web.ContentViewService", "name": "org.nuxeo.ecm.platform.ui.web.ContentViewService", "type": "service" }, "version": "10.10", "xml": "\n \n\n label.contentview.document_content\n true\n false\n\n \n #{documentManager}\n DEFAULT_NAVIGATION_RESULTS\n \n \n \n \n \n \n \n \n \n \n \n \n ecm:parentId = ? AND ecm:isVersion = 0 AND\n ecm:mixinType !=\n 'HiddenInNavigation' AND\n ecm:isTrashed = 0\n \n \n #{currentDocument.id}\n \n 20\n \n\n \n true\n\n true\n true\n \n documentChanged\n documentChildrenChanged\n \n #{currentDocument.repositoryName}_#{currentDocument.id}\n 10\n\n \n \n \n \n\n CURRENT_SELECTION\n \n\n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.contentview.contrib", "name": "org.nuxeo.ecm.platform.mail.jsf.contentview.contrib", "requirements": [], "resolutionOrder": 436, "services": [], "startOrder": 383, "version": "10.10", "xmlFileContent": "\n\n\n \n \n\n label.contentview.document_content\n true\n false\n\n \n #{documentManager}\n DEFAULT_NAVIGATION_RESULTS\n \n \n \n \n \n \n \n \n \n \n \n \n ecm:parentId = ? AND ecm:isVersion = 0 AND\n ecm:mixinType !=\n 'HiddenInNavigation' AND\n ecm:isTrashed = 0\n \n \n #{currentDocument.id}\n \n 20\n \n\n \n true\n\n true\n true\n \n documentChanged\n documentChildrenChanged\n \n #{currentDocument.repositoryName}_#{currentDocument.id}\n 10\n\n \n \n \n \n\n CURRENT_SELECTION\n \n\n \n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-contentview-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.forms.layout.WebLayoutManager--widgettypes", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.layouts.contrib/Contributions/org.nuxeo.ecm.platform.mail.jsf.layouts.contrib--widgettypes", "id": "org.nuxeo.ecm.platform.mail.jsf.layouts.contrib--widgettypes", "registrationOrder": 16, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.forms.layout.WebLayoutManager", "name": "org.nuxeo.ecm.platform.forms.layout.WebLayoutManager", "type": "service" }, "version": "10.10", "xml": "\n\n \n\n \n This widget type displays the first words of the mail Body\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the mail text property.\n
    • \n
  • \n first field mapping the mail htmlText property.\n
    • \n
  • \n first field mapping the document title property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_body_widget_template.xhtml\n \n\n \n\n \n\n \n This widget type displays the mail addresses within a mailTo link.\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the mail sender property.\n
    • \n
  • \n second field mapping the mail recipient property.\n
    • \n
  • \n third field mapping the mail cc_recipient property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_contact_widget_template.xhtml\n \n\n \n\n \n\n \n This widget type displays the mail object and the sending date.\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the dublincore title property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_object_widget_template.xhtml\n \n \n\n \n\n \n This widget type displays the sending date.\n
\n It requires the following fields configuration:\n
    \n
  • \n First field mapping the mail sending_date property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n\n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_sending_date_widget_template.xhtml\n \n \n\n \n\n \n This widget type displays the mail attachments. This widget requires\n a document with the files schema.\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the files property.\n
    • \n
  • \n second field mapping the document.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n\n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_attachments_widget_template.xhtml\n \n \n " }, { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.forms.layout.WebLayoutManager--layouts", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.layouts.contrib/Contributions/org.nuxeo.ecm.platform.mail.jsf.layouts.contrib--layouts", "id": "org.nuxeo.ecm.platform.mail.jsf.layouts.contrib--layouts", "registrationOrder": 23, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.forms.layout.WebLayoutManager", "name": "org.nuxeo.ecm.platform.forms.layout.WebLayoutManager", "type": "service" }, "version": "10.10", "xml": "\n\n \n \n \n \n \n \n \n \n true\n \n false\n iconColumn\n \n \n true\n \n \n true\n \n listing_ajax_selection_box_with_current_document\n \n \n \n false\n iconColumn\n \n listing_icon_type\n \n \n \n false\n false\n \n listing_mail_object\n listing_mail_sending_date\n listing_mail_contact\n listing_mail_body\n \n \n \n false\n false\n \n listing_mail_attachments\n \n \n\n \n \n \n \n true\n \n data\n data.ref\n \n \n view\n \n \n \n \n \n \n \n view\n \n \n data.mail.sending_date\n \n \n \n \n \n \n \n view\n \n \n data.mail.sender\n data.mail.recipients\n data.mail.cc_recipients\n \n \n \n \n \n \n \n view\n \n \n data.mail.text\n data.mail.htmlText\n data.dc.title\n data.id\n \n \n \n \n \n \n \n view\n \n \n data.files.files\n data\n \n \n \n\n \n \n \n \n \n \t\n title\n \n \n sender\n \n \n sending_date\n \n \n recipients\n \n \n cc_recipients\n \n \n text\n \n \n \n \n \n \n \n view\n \n true\n \n dc:title\n \n \n true\n \n \n \n \n \n \n \n view\n \n \n mail:sender\n \n \n \n \n \n \n \n view\n \n \n mail:sending_date\n \n \n #{nxu:basicDateAndTimeFormatter()}\n \n \n \n \n \n \n \n view\n \n \n mail:recipients\n \n \n /widgets/join_list_widget_template.xhtml\n \n \n \n \n \n \n \n view\n \n \n mail:cc_recipients\n \n \n /widgets/join_list_widget_template.xhtml\n \n \n \n \n \n \n \n view\n \n \n /widgets/email_text_widget_template.xhtml\n \n \n id\n repositoryName\n \n \n \n \n \n \n \n \n \n \n files\n \n \n \n \n \n \n true\n \n files\n \n \n true\n \n \n true\n \n \n \n \n \n true\n \n file\n file/name\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \n \n email\n \n \n password\n \n \n protocol_type\n \n \n host\n \n \n port\n \n \n socket_factory_fallback\n \n \n socket_factory_port\n \n \n starttls_enable\n \n \n ssl_protocols\n \n \n emails_limit\n \n \n \n \n \n \n true\n \n dc:title\n \n \n true\n \n \n \n \n \n \n \n prot:email\n \n \n dataInputText\n true\n \n \n ********\n \n \n \n prot:password\n \n \n dataInputText\n true\n true\n \n \n \n \n \n \n \n prot:protocol_type\n \n \n true\n \n \n \n /widgets/protocol_type_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:host\n \n \n dataInputText\n \n \n \n \n \n \n \n prot:port\n \n \n dataInputText\n \n \n \n \n \n \n \n prot:socket_factory_fallback\n \n \n \n /widgets/boolean_radio_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:socket_factory_port\n \n \n dataInputText\n \n \n \n \n \n \n \n prot:starttls_enable\n \n \n \n /widgets/boolean_radio_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:ssl_protocols\n \n \n \n /widgets/emails_ssl_protocols_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:emails_limit\n \n \n true\n \n \n \n /widgets/emails_limit_widget_template.xhtml\n \n \n \n \n\n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf/org.nuxeo.ecm.platform.mail.jsf.layouts.contrib", "name": "org.nuxeo.ecm.platform.mail.jsf.layouts.contrib", "requirements": [ "org.nuxeo.ecm.platform.forms.layouts.webapp" ], "resolutionOrder": 709, "services": [], "startOrder": 384, "version": "10.10", "xmlFileContent": "\n\n org.nuxeo.ecm.platform.forms.layouts.webapp\n\n \n\n \n\n \n This widget type displays the first words of the mail Body\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the mail text property.\n
    • \n
  • \n first field mapping the mail htmlText property.\n
    • \n
  • \n first field mapping the document title property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_body_widget_template.xhtml\n \n\n \n\n \n\n \n This widget type displays the mail addresses within a mailTo link.\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the mail sender property.\n
    • \n
  • \n second field mapping the mail recipient property.\n
    • \n
  • \n third field mapping the mail cc_recipient property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_contact_widget_template.xhtml\n \n\n \n\n \n\n \n This widget type displays the mail object and the sending date.\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the dublincore title property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_object_widget_template.xhtml\n \n \n\n \n\n \n This widget type displays the sending date.\n
\n It requires the following fields configuration:\n
    \n
  • \n First field mapping the mail sending_date property.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n\n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_sending_date_widget_template.xhtml\n \n \n\n \n\n \n This widget type displays the mail attachments. This widget requires\n a document with the files schema.\n
\n It requires the following fields configuration:\n
    \n
  • \n first field mapping the files property.\n
    • \n
  • \n second field mapping the document.\n
    • \n
\n \n \n \n configuration_not_ready\n \n \n\n \n org.nuxeo.ecm.platform.forms.layout.facelets.plugins.TemplateWidgetTypeHandler\n \n \n /widgets/listing/listing_mail_attachments_widget_template.xhtml\n \n \n \n\n \n\n \n \n \n \n \n \n \n \n true\n \n false\n iconColumn\n \n \n true\n \n \n true\n \n listing_ajax_selection_box_with_current_document\n \n \n \n false\n iconColumn\n \n listing_icon_type\n \n \n \n false\n false\n \n listing_mail_object\n listing_mail_sending_date\n listing_mail_contact\n listing_mail_body\n \n \n \n false\n false\n \n listing_mail_attachments\n \n \n\n \n \n \n \n true\n \n data\n data.ref\n \n \n view\n \n \n \n \n \n \n \n view\n \n \n data.mail.sending_date\n \n \n \n \n \n \n \n view\n \n \n data.mail.sender\n data.mail.recipients\n data.mail.cc_recipients\n \n \n \n \n \n \n \n view\n \n \n data.mail.text\n data.mail.htmlText\n data.dc.title\n data.id\n \n \n \n \n \n \n \n view\n \n \n data.files.files\n data\n \n \n \n\n \n \n \n \n \n \t\n title\n \n \n sender\n \n \n sending_date\n \n \n recipients\n \n \n cc_recipients\n \n \n text\n \n \n \n \n \n \n \n view\n \n true\n \n dc:title\n \n \n true\n \n \n \n \n \n \n \n view\n \n \n mail:sender\n \n \n \n \n \n \n \n view\n \n \n mail:sending_date\n \n \n #{nxu:basicDateAndTimeFormatter()}\n \n \n \n \n \n \n \n view\n \n \n mail:recipients\n \n \n /widgets/join_list_widget_template.xhtml\n \n \n \n \n \n \n \n view\n \n \n mail:cc_recipients\n \n \n /widgets/join_list_widget_template.xhtml\n \n \n \n \n \n \n \n view\n \n \n /widgets/email_text_widget_template.xhtml\n \n \n id\n repositoryName\n \n \n \n \n \n \n \n \n \n \n files\n \n \n \n \n \n \n true\n \n files\n \n \n true\n \n \n true\n \n \n \n \n \n \n true\n \n file\n file/name\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \n \n email\n \n \n password\n \n \n protocol_type\n \n \n host\n \n \n port\n \n \n socket_factory_fallback\n \n \n socket_factory_port\n \n \n starttls_enable\n \n \n ssl_protocols\n \n \n emails_limit\n \n \n \n \n \n \n true\n \n dc:title\n \n \n true\n \n \n \n \n \n \n \n prot:email\n \n \n dataInputText\n true\n \n \n ********\n \n \n \n prot:password\n \n \n dataInputText\n true\n true\n \n \n \n \n \n \n \n prot:protocol_type\n \n \n true\n \n \n \n /widgets/protocol_type_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:host\n \n \n dataInputText\n \n \n \n \n \n \n \n prot:port\n \n \n dataInputText\n \n \n \n \n \n \n \n prot:socket_factory_fallback\n \n \n \n /widgets/boolean_radio_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:socket_factory_port\n \n \n dataInputText\n \n \n \n \n \n \n \n prot:starttls_enable\n \n \n \n /widgets/boolean_radio_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:ssl_protocols\n \n \n \n /widgets/emails_ssl_protocols_widget_template.xhtml\n \n \n \n \n \n \n \n \n prot:emails_limit\n \n \n true\n \n \n \n /widgets/emails_limit_widget_template.xhtml\n \n \n \n \n\n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-layouts-contrib.xml", "xmlPureComponent": true } ], "fileName": "nuxeo-platform-mail-jsf-10.10.jar", "groupId": "org.nuxeo.ecm.platform", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.jsf", "id": "org.nuxeo.ecm.platform.mail.jsf", "location": "", "manifest": "Manifest-Version: 1.0\r\nArchiver-Version: Plexus Archiver\r\nCreated-By: Apache Maven\r\nBuilt-By: jenkins\r\nBuild-Jdk: 1.8.0_191\r\nBundle-ManifestVersion: 2\r\nBundle-Version: 1.0.0\r\nBundle-Name: Nuxeo ECM Mail JSF\r\nBundle-SymbolicName: org.nuxeo.ecm.platform.mail.jsf;singleton:=true\r\nBundle-Localization: plugin\r\nBundle-Vendor: Nuxeo\r\nBundle-Category: stateless\r\nEclipse-LazyStart: false\r\nRequire-Bundle: org.nuxeo.ecm.core.api,org.nuxeo.ecm.webapp.core,org.\r\n nuxeo.ecm.platform.mail\r\nNuxeo-Component: OSGI-INF/nxmail-actions-contrib.xml,OSGI-INF/nxmail-l\r\n ayouts-contrib.xml,OSGI-INF/nxmail-contentview-contrib.xml\r\n\r\n", "maxResolutionOrder": 709, "minResolutionOrder": 435, "packages": [ "nuxeo-imap-connector" ], "parentReadme": { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" }, "requirements": [ "org.nuxeo.ecm.core.api", "org.nuxeo.ecm.webapp.core", "org.nuxeo.ecm.platform.mail" ], "version": "10.10" }, { "@type": "NXBundle", "artifactId": "nuxeo-platform-mail-types", "artifactVersion": "10.10", "bundleGroup": { "@type": "NXBundleGroup", "bundleIds": [ "org.nuxeo.ecm.platform.mail", "org.nuxeo.ecm.platform.mail.jsf", "org.nuxeo.ecm.platform.mail.types", "org.nuxeo.ecm.platform.mail.webui" ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail", "id": "grp:org.nuxeo.ecm.platform.mail", "name": "org.nuxeo.ecm.platform.mail", "parentIds": [ "grp:org.nuxeo.ecm.platform" ], "readmes": [ { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n", "digest": "5c14b7245188fbe51fcebd6e4c6eff98", "encoding": "UTF-8", "length": 7955, "mimeType": "text/plain", "name": "README.md" }, { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" } ], "version": "10.10" }, "bundleId": "org.nuxeo.ecm.platform.mail.types", "components": [ { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.schema.TypeService--schema", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.core.types.contrib/Contributions/org.nuxeo.ecm.platform.mail.core.types.contrib--schema", "id": "org.nuxeo.ecm.platform.mail.core.types.contrib--schema", "registrationOrder": 21, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.schema.TypeService", "name": "org.nuxeo.ecm.core.schema.TypeService", "type": "service" }, "version": "10.10", "xml": "\n\n \n \n\n " }, { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.schema.TypeService--doctype", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.core.types.contrib/Contributions/org.nuxeo.ecm.platform.mail.core.types.contrib--doctype", "id": "org.nuxeo.ecm.platform.mail.core.types.contrib--doctype", "registrationOrder": 19, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.schema.TypeService", "name": "org.nuxeo.ecm.core.schema.TypeService", "type": "service" }, "version": "10.10", "xml": "\n\n \n \n \n \n \n \n \n \n \n \n\n \n \n \n MailMessage\n \n \n\n \n \n \n MailFolder\n \n \n\n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.core.types.contrib", "name": "org.nuxeo.ecm.platform.mail.core.types.contrib", "requirements": [ "org.nuxeo.ecm.core.CoreExtensions" ], "resolutionOrder": 437, "services": [], "startOrder": 381, "version": "10.10", "xmlFileContent": "\n\n\n org.nuxeo.ecm.core.CoreExtensions\n\n \n\n \n \n\n \n\n \n\n \n \n \n \n \n \n \n \n \n \n\n \n \n \n MailMessage\n \n \n\n \n \n \n MailFolder\n \n \n\n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-core-types-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.types.TypeService--types", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.web.types.contrib/Contributions/org.nuxeo.ecm.platform.mail.web.types.contrib--types", "id": "org.nuxeo.ecm.platform.mail.web.types.contrib--types", "registrationOrder": 5, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.types.TypeService", "name": "org.nuxeo.ecm.platform.types.TypeService", "type": "service" }, "version": "10.10", "xml": "\n\n \n \n /icons/mail.png\n /icons/mail_100.png\n SimpleDocument\n view_documents\n \n mailMessage\n noLabelFiles\n \n \n mailMessage\n noLabelFiles\n dublincore\n \n \n \n mailMessage\n \n \n\n \n \n /icons/mail_folder.png\n /icons/mailfolder_100.png\n Collaborative\n view_documents\n \n mail_folder\n \n \n mail_document_content\n \n \n \n document_trash_content\n \n \n \n\n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.web.types.contrib", "name": "org.nuxeo.ecm.platform.mail.web.types.contrib", "requirements": [], "resolutionOrder": 438, "services": [], "startOrder": 387, "version": "10.10", "xmlFileContent": "\n\n\n \n\n \n \n /icons/mail.png\n /icons/mail_100.png\n SimpleDocument\n view_documents\n \n mailMessage\n noLabelFiles\n \n \n mailMessage\n noLabelFiles\n dublincore\n \n \n \n mailMessage\n \n \n\n \n \n /icons/mail_folder.png\n /icons/mailfolder_100.png\n Collaborative\n view_documents\n \n mail_folder\n \n \n mail_document_content\n \n \n \n document_trash_content\n \n \n \n\n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-ecm-types-contrib.xml", "xmlPureComponent": true }, { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.core.lifecycle.LifeCycleService--types", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.core.lifecycle.contrib/Contributions/org.nuxeo.ecm.platform.mail.core.lifecycle.contrib--types", "id": "org.nuxeo.ecm.platform.mail.core.lifecycle.contrib--types", "registrationOrder": 11, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.core.lifecycle.LifeCycleService", "name": "org.nuxeo.ecm.core.lifecycle.LifeCycleService", "type": "service" }, "version": "10.10", "xml": "\n \n default\n default\n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types/org.nuxeo.ecm.platform.mail.core.lifecycle.contrib", "name": "org.nuxeo.ecm.platform.mail.core.lifecycle.contrib", "requirements": [ "org.nuxeo.ecm.platform.mail.core.types.contrib", "org.nuxeo.ecm.core.CoreExtensions" ], "resolutionOrder": 439, "services": [], "startOrder": 377, "version": "10.10", "xmlFileContent": "\n\n org.nuxeo.ecm.core.CoreExtensions\n org.nuxeo.ecm.platform.mail.core.types.contrib\n\n \n \n default\n default\n \n \n\n\n", "xmlFileName": "/OSGI-INF/nxmail-lifecycle-contrib.xml", "xmlPureComponent": true } ], "fileName": "nuxeo-platform-mail-types-10.10.jar", "groupId": "org.nuxeo.ecm.platform", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.types", "id": "org.nuxeo.ecm.platform.mail.types", "location": "", "manifest": "Manifest-Version: 1.0\r\nArchiver-Version: Plexus Archiver\r\nCreated-By: Apache Maven\r\nBuilt-By: jenkins\r\nBuild-Jdk: 1.8.0_191\r\nBundle-ManifestVersion: 2\r\nBundle-Version: 10.10-t20190122-092042\r\nBundle-Name: Nuxeo ECM Mail Core\r\nBundle-SymbolicName: org.nuxeo.ecm.platform.mail.types;singleton:=true\r\nBundle-Vendor: Nuxeo\r\nRequire-Bundle: org.nuxeo.ecm.core.api,org.nuxeo.ecm.core\r\nBundle-Category: core\r\nEclipse-LazyStart: false\r\nNuxeo-Component: OSGI-INF/nxmail-core-types-contrib.xml,OSGI-INF/nxmai\r\n l-ecm-types-contrib.xml,OSGI-INF/nxmail-lifecycle-contrib.xml\r\nProvide-Package: org.nuxeo.ecm.platform.mail.types\r\n\r\n", "maxResolutionOrder": 439, "minResolutionOrder": 437, "packages": [ "nuxeo-imap-connector" ], "parentReadme": { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" }, "requirements": [ "org.nuxeo.ecm.core.api", "org.nuxeo.ecm.core" ], "version": "10.10" }, { "@type": "NXBundle", "artifactId": "nuxeo-platform-mail-web-ui", "artifactVersion": "10.10", "bundleGroup": { "@type": "NXBundleGroup", "bundleIds": [ "org.nuxeo.ecm.platform.mail", "org.nuxeo.ecm.platform.mail.jsf", "org.nuxeo.ecm.platform.mail.types", "org.nuxeo.ecm.platform.mail.webui" ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail", "id": "grp:org.nuxeo.ecm.platform.mail", "name": "org.nuxeo.ecm.platform.mail", "parentIds": [ "grp:org.nuxeo.ecm.platform" ], "readmes": [ { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n", "digest": "5c14b7245188fbe51fcebd6e4c6eff98", "encoding": "UTF-8", "length": 7955, "mimeType": "text/plain", "name": "README.md" }, { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" } ], "version": "10.10" }, "bundleId": "org.nuxeo.ecm.platform.mail.webui", "components": [ { "@type": "NXComponent", "documentationHtml": "", "extensionPoints": [], "extensions": [ { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.WebResources--resources", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.webui/org.nuxeo.ecm.platform.mail.web.ui.resources.contrib/Contributions/org.nuxeo.ecm.platform.mail.web.ui.resources.contrib--resources", "id": "org.nuxeo.ecm.platform.mail.web.ui.resources.contrib--resources", "registrationOrder": 29, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.WebResources", "name": "org.nuxeo.ecm.platform.WebResources", "type": "service" }, "version": "10.10", "xml": "\n \n /ui/nuxeo-platform-mail/nuxeo-platform-mail.html\n \n " }, { "@type": "NXContribution", "documentationHtml": "", "extensionPoint": "org.nuxeo.ecm.platform.WebResources--bundles", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.webui/org.nuxeo.ecm.platform.mail.web.ui.resources.contrib/Contributions/org.nuxeo.ecm.platform.mail.web.ui.resources.contrib--bundles", "id": "org.nuxeo.ecm.platform.mail.web.ui.resources.contrib--bundles", "registrationOrder": 22, "targetComponentName": { "rawName": "service:org.nuxeo.ecm.platform.WebResources", "name": "org.nuxeo.ecm.platform.WebResources", "type": "service" }, "version": "10.10", "xml": "\n \n \n nuxeo-platform-mail.html\n \n \n " } ], "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.webui/org.nuxeo.ecm.platform.mail.web.ui.resources.contrib", "name": "org.nuxeo.ecm.platform.mail.web.ui.resources.contrib", "requirements": [ "org.nuxeo.web.ui.resources" ], "resolutionOrder": 960, "services": [], "startOrder": 388, "version": "10.10", "xmlFileContent": "\r\n\r\n org.nuxeo.web.ui.resources\r\n\r\n \r\n \r\n /ui/nuxeo-platform-mail/nuxeo-platform-mail.html\r\n \r\n \r\n\r\n \r\n \r\n \r\n nuxeo-platform-mail.html\r\n \r\n \r\n \r\n", "xmlFileName": "/OSGI-INF/nuxeo-platform-mail-webresources-contrib.xml", "xmlPureComponent": true } ], "fileName": "nuxeo-platform-mail-web-ui-10.10.jar", "groupId": "org.nuxeo.ecm.platform", "hierarchyPath": "/grp:org.nuxeo.ecm.platform/grp:org.nuxeo.ecm.platform.mail/org.nuxeo.ecm.platform.mail.webui", "id": "org.nuxeo.ecm.platform.mail.webui", "location": "", "manifest": "Manifest-Version: 1.0\r\nArchiver-Version: Plexus Archiver\r\nCreated-By: Apache Maven\r\nBuilt-By: jenkins\r\nBuild-Jdk: 1.8.0_191\r\nBundle-ManifestVersion: 1\r\nBundle-Version: 1.0.0\r\nBundle-Name: Nuxeo ECM Mail Web UI\r\nBundle-SymbolicName: org.nuxeo.ecm.platform.mail.webui;singleton:=true\r\nBundle-Vendor: Nuxeo\r\nNuxeo-Component: OSGI-INF/nuxeo-platform-mail-webresources-contrib.xml\r\n\r\n", "maxResolutionOrder": 960, "minResolutionOrder": 960, "packages": [ "nuxeo-imap-connector" ], "parentReadme": { "blobProviderId": "default", "content": "nuxeo-platform-mail\n===================\n\n## About\n\nThe `nuxeo-platform-mail` module provides the `MailFolder` feature : you can configure Nuxeo Server to fetch emails from a Pop3/Imapc server and have Nuxeo convert the emails into Nuxeo Documents and store them inside a Folder.\n\n## Mail server connection\n\nOne important aspect of nuxeo-platform-mail consists in the fact that multiple\nemail connections can be dynamically configured from the web UI interface.\n\nThis is done by creating \"Email folder\" documents, which contain the parameters\nneeded in order to connect to the email account. \n\nPeriodaically (this is configured in {{nxmail-scheduler-config.xml}}), all\nthe email accounts defined by the \"Email folders\" are checked for new incoming\nmail. \n\nFor every new mail found in a certain account, a new corresponding \n\"Email message\" is created as a child of the \"Email folder\" corresponding to\nthe email account.\n\nAlso, an email account check can be triggered for a certain \"Email folder\", \nby clicking the \"Check email\" button which can be found in the view page of\nan \"Email folder\" document.\n\nNote: For performance reasons, only a limited number of emails are\nimported for every account check. This limit can be set when a the\ncreation/modification of a MailFolder document.\n\n## Configuration\n\n### Extension point configuration\n\nMail Servers are configured at the MailFolder level.\n\nHowever, you can also control how the MailFolder will convert emails into Nuxeo Document.\n\nThe service uses a chain of actions that is configured using the `actionPipes` extension point :\n\nThe default configuration contains :\n\n \n org.nuxeo.ecm.platform.mail.listener.action.StartAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CheckMailUnicity\n \n \n org.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsAction\n \n \n org.nuxeo.ecm.platform.mail.listener.action.EndAction\n \n\nThe action that will actually create the Document is `CreateDocumentsAction`.\n\nSo, if you want the mail folder to create custom Document types, you have to contribute your own Action and overriding the default chain.\n\nHowever, if you don't want to do Java Code and prefer using Automation, since 6.0, you can.\n\n### Automation Bridge\n\nSince 6.0 a new MailAction is available and allows to call an Automation Chain.\n\n\n#### Configuraring the system to use Automation\n\nYou must override the default actionPipe and use the `CreateDocumentsFromAutomationChainAction` action\n\n\t\n\t\n\t \n\t org.nuxeo.ecm.platform.mail.service.MailServiceContrib\n\t \n\t \n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.StartAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.ExtractMessageInformationAction\n\t \n\t \n\t\torg.nuxeo.ecm.platform.mail.listener.action.CreateDocumentsFromAutomationChainAction\n\t \n\t \n\n\t \n\n\t\n\n#### Automation Execution Context\n\nThe Automation context is filled with the ExecutionContext used in the MailActionPipe :\n\n - `mailFolder` : is the target MailFolder document\n - `mailDocumentName` : is the computed name for the Mail Document (it is not required to use it)\n - `executionContext` : is the `ExecutionContext` defined in the pipe\n - all properties available in the `ExecutionContext` are dumped at root of Automation Context :\n - `subject` is the mail subject\n - `recipients` is the list of recipients\n - `ccRecipients` is the list of recipients in CC\n - `sendingDate` is the date the mail was sent\n - `attachments` is the list of attached Blobs\n\n#### Chain example\n\nThe Chain itself should be something like : \n\n\n \n \n mailFolder\n \n \n MailMessage\n expr:Context[\"mailDocumentName\"]\n expr:mail:messageId=@{messageId}\n \n \n \n mailDocument\n \n \n \n \n Context[\"mailDocument\"].setPropertyValue(\"dc:title\",Context[\"subject\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:recipients\",Context[\"recipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:cc_recipients\",Context[\"ccRecipients\"]);\n Context[\"mailDocument\"].setPropertyValue(\"mail:sending_date\",Context[\"sendingDate\"]);\n \n \n \n \n ProcessAttachment\n attachments\n true\n attachment\n \n \n mailDocument\n \n \n \n \n \n attachment\n \n \n expr:Context[\"mailDocument\"]\n false\n files:files\n \n \n\n\n## About using SSL with you mail server\n\nIf you connect to your mail server using SSL, your server needs to\nhave a valid certificate, that is, a certificate that is issued by a\nknown Authority. \n\nIf this is not the case (you're using a self-made\ncertificate), then the JVM will refuse to connect and you'll have a\nSSLHandShake error.\n\nTo be able to connect with a server with a self-signed certificate, you\nneed to add this certificate to the trusted certificate using keytool\nwith a command such as (see man keytool for more information):\n\n keytool -import -trustcacerts -file mail.cer -keystore thekeystore\n\nIf you don't have the certificate of the mail server you can get it\nwith the following command:\n\n openssl s_client -connect my.mailserver.com:PORT\n\nYou can either import the certificate in the cacerts of your JVM, or\ncreate a new keystore and start the jvm with:\n\n -Djavax.net.ssl.trustStore=/home/foo/.keystore\n\nAnother option is to use an helper class from:\nhttp://blogs.sun.com/andreas/entry/no_more_unable_to_find\nand to follow this step:\n\n1/ run the TestConnection class in eclipse as an application with your\n connection parameters\n\n2/ if not working (error 'unable to find valid certification path to\n requested target') compile the java class:\n $ java InstallCert.java\n\n3/ execute on imap server for instance:\n $ java InstallCert mail.example.com\n or\n $ java InstallCert mail.example.com:993\n\n4/ make sure it is a good key before entering, and make sure it's been\n added to the default keystore in $JAVA_HOME/jre/lib/security/cacerts\n\n5/ reproduce steps if needed, *do not forget to delete* the local file\n 'jssecacerts' that's been created (otherwise the default keystore won't\n be updated anymore)\n\nTo test your setting you can use this class:\nA TestConnection class sample\n\n\tpublic class TestImapConnection {\n\n\t public static void main(String args[]) throws Exception {\n\t\tProperties props = new Properties();\n\n\t\tprops.put(\"user\", \"email@example.com\");\n\t\tprops.put(\"password\", \"password\");\n\n\t\tprops.put(\"mail.store.protocol\", \"imap\");\n\t\tprops.put(\"mail.imap.host\", \"mail.example.com\");\n\t\tprops.put(\"mail.imap.port\", \"993\");\n\t\tprops.put(\"mail.imap.ssl.protocols\", \"SSL\");\n\t\tprops.put(\"mail.imap.starttls.enable\", \"true\");\n\n\t\tprops.put(\"mail.imap.socketFactory.class\",\n\t\t \"javax.net.ssl.SSLSocketFactory\");\n\t\tprops.put(\"mail.imap.socketFactory.port\", \"993\");\n\t\tprops.put(\"mail.imap.socketFactory.fallback\", \"false\");\n\n\t\tSession session = Session.getDefaultInstance(props);\n\n\t\tStore store = session.getStore();\n\t\tSystem.err.println(\"connecting\");\n\t\tstore.connect(props.getProperty(\"user\").toString(), props.getProperty(\n\t\t \"password\").toString());\n\n\t\tstore.close();\n\t\tSystem.err.println(\"done\");\n\t }\n\n\t}\n\n", "digest": "217a171a23d7f4a581c38d55e9c5ce05", "encoding": "UTF-8", "length": 8979, "mimeType": "text/plain", "name": "README.md" }, "requirements": [], "version": "10.10" } ], "creationDate": 1664793571025, "key": "Nuxeo Platform LTS 2019-10.10", "name": "Nuxeo Platform LTS 2019", "operations": [ { "@type": "NXOperation", "aliases": [], "category": "Chain", "contributingComponent": "org.nuxeo.mail.automation.chains", "hierarchyPath": "/op:ProcessAttachment", "label": "ProcessAttachment", "name": "ProcessAttachment", "operationClass": "org.nuxeo.ecm.automation.core.impl.OperationChainCompiler.CompiledChainImpl", "params": [], "signature": [ "void", "blob" ], "since": "", "url": "ProcessAttachment", "version": "10.10" }, { "@type": "NXOperation", "aliases": [], "category": "Services", "contributingComponent": "org.nuxeo.ecm.platform.mail.core.operations.contrib", "description": "Checks for unread emails in the inbox of an Email Folder passed as input.", "hierarchyPath": "/op:Mail.CheckInbox", "label": "Check Mail Inbox", "name": "Mail.CheckInbox", "operationClass": "org.nuxeo.ecm.platform.mail.operations.MailCheckInboxOperation", "params": [], "signature": [ "document", "void" ], "since": "", "url": "Mail.CheckInbox", "version": "10.10" }, { "@type": "NXOperation", "aliases": [], "category": "Chain", "contributingComponent": "org.nuxeo.mail.automation.chains", "hierarchyPath": "/op:CreateMailDocumentFromAutomation", "label": "CreateMailDocumentFromAutomation", "name": "CreateMailDocumentFromAutomation", "operationClass": "org.nuxeo.ecm.automation.core.impl.OperationChainCompiler.CompiledChainImpl", "params": [], "signature": [ "void", "document" ], "since": "", "url": "CreateMailDocumentFromAutomation", "version": "10.10" } ], "packages": [ { "@type": "NXPackage", "bundles": [ "org.nuxeo.ecm.platform.mail", "org.nuxeo.ecm.platform.mail.jsf", "org.nuxeo.ecm.platform.mail.types", "org.nuxeo.ecm.platform.mail.webui" ], "conflicts": [], "dependencies": [], "hierarchyPath": "/nuxeo-imap-connector-1.4.3", "id": "nuxeo-imap-connector-1.4.3", "name": "nuxeo-imap-connector", "optionalDependencies": [ "nuxeo-jsf-ui", "nuxeo-web-ui" ], "packageType": "addon", "title": "Nuxeo IMAP Connector", "version": "1.4.3" } ], "pluginSnapshots": {}, "releaseDate": 1547942400000, "version": "10.10" }